CouchDB একটি ডকুমেন্ট-ভিত্তিক NoSQL ডাটাবেস, এবং Java এর সঙ্গে ইন্টিগ্রেশন করার জন্য অনেকগুলো পদ্ধতি রয়েছে। Ektorp হল Java এর জন্য একটি ওপেন সোর্স লাইব্রেরি যা CouchDB এর সঙ্গে ইন্টিগ্রেটেড ডেভেলপমেন্টের সুবিধা প্রদান করে। Ektorp API ব্যবহার করে CouchDB-তে ডেটা ইন্টারঅ্যাক্ট করা, CRUD অপারেশন চালানো এবং ডেটাবেসের অন্যান্য কার্যক্রম করা সহজ হয়।

এই গাইডে, আমরা Ektorp API ব্যবহার করে CouchDB এর সঙ্গে Java ইন্টিগ্রেশন করার পদ্ধতি বিস্তারিতভাবে আলোচনা করব।

1. Ektorp API সেটআপ

Ektorp API CouchDB এর Java ক্লায়েন্ট লাইব্রেরি, যা ডেটাবেসের সঙ্গে যোগাযোগ করার জন্য একাধিক সুবিধা প্রদান করে। প্রথমে, আপনাকে Ektorp লাইব্রেরি আপনার প্রোজেক্টে অন্তর্ভুক্ত করতে হবে।

Maven Dependency

যদি আপনি Maven ব্যবহার করেন, তাহলে pom.xml ফাইলের মধ্যে নিচের ডিপেন্ডেন্সি যোগ করুন:

<dependency>
    <groupId>org.ektorp</groupId>
    <artifactId>ektorp</artifactId>
    <version>1.4</version>
</dependency>

Gradle Dependency

যদি আপনি Gradle ব্যবহার করেন, তাহলে আপনার build.gradle ফাইলে নিচের কোডটি যোগ করুন:

implementation 'org.ektorp:ektorp:1.4'

2. CouchDB সার্ভার কনফিগারেশন

Ektorp API ব্যবহার করতে, প্রথমে আপনার CouchDB সার্ভারের তথ্য প্রদান করতে হবে, যেমন CouchDB এর URL এবং ডেটাবেসের নাম। এটি Java অ্যাপ্লিকেশন থেকে CouchDB এর সঙ্গে যোগাযোগ করতে সহায়ক হবে।

CouchDB কনফিগারেশন উদাহরণ

import org.ektorp.CouchDbConnector;
import org.ektorp.impl.StdCouchDbConnector;
import org.ektorp.http.HttpClient;
import org.ektorp.http.StdHttpClient;

public class CouchDbConfig {
    public static CouchDbConnector connector;

    public static void setUpCouchDB() {
        // CouchDB সার্ভারের URL এবং ডেটাবেসের নাম
        String couchDbUrl = "http://localhost:5984"; // CouchDB URL
        String databaseName = "my_database"; // ডেটাবেসের নাম

        // HttpClient কনফিগারেশন
        HttpClient httpClient = new StdHttpClient.Builder()
                .url(couchDbUrl)
                .username("admin") // ব্যবহারকারী নাম (যদি প্রয়োজন হয়)
                .password("password") // পাসওয়ার্ড (যদি প্রয়োজন হয়)
                .build();

        // CouchDbConnector তৈরি
        connector = new StdCouchDbConnector(databaseName, httpClient);
    }
}

• এখানে, StdHttpClient ক্লাস ব্যবহার করে CouchDB সার্ভারের URL, ইউজারনেম এবং পাসওয়ার্ড কনফিগার করা হয়েছে।
• CouchDbConnector ক্লাসটি ডেটাবেসের সাথে Java অ্যাপ্লিকেশনের যোগাযোগ সহজ করে দেয়।

3. CouchDB তে ডেটা যোগ করা (Create Operation)

CouchDB তে ডেটা যুক্ত করতে Ektorp ব্যবহার করা যেতে পারে। Ektorp API তে CouchDbConnector ক্লাসের মাধ্যমে Document তৈরি, রিড, আপডেট, এবং ডিলিট অপারেশন করা যায়।

Document Class তৈরি

CouchDB তে Document যোগ করার জন্য প্রথমে একটি Java ক্লাস তৈরি করতে হবে, যা আপনার ডকুমেন্টের কাঠামো প্রতিনিধিত্ব করবে।

import org.ektorp.support.CouchDbDocument;

public class User extends CouchDbDocument {
    private String name;
    private String email;

    // Getter and Setter methods
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }
}

এই ক্লাসটি CouchDbDocument থেকে উত্তরাধিকারসূত্রে পেয়েছে, যা CouchDB এর ডকুমেন্টের জন্য স্ট্যান্ডার্ড ক্লাস হিসেবে কাজ করে।

ডেটাবেসে ডকুমেন্ট যোগ করা

এখন CouchDbConnector এর মাধ্যমে একটি নতুন ডকুমেন্ট (যেমন User) ডেটাবেসে যুক্ত করতে হবে:

public class CouchDbService {

    public static void addUser(String name, String email) {
        // User ডকুমেন্ট তৈরি
        User user = new User();
        user.setName(name);
        user.setEmail(email);

        // ডকুমেন্ট ডেটাবেসে যুক্ত করা
        connector.create(user);
    }
}

এখানে, create মেথডটি নতুন User ডকুমেন্টকে CouchDB ডেটাবেসে যুক্ত করবে।

4. CouchDB থেকে ডেটা রিড করা (Read Operation)

CouchDB থেকে ডেটা রিড করতে, আপনি নির্দিষ্ট ডকুমেন্টের _id এর মাধ্যমে তা অ্যাক্সেস করতে পারবেন।

ডেটাবেস থেকে ডকুমেন্ট রিড করা

public class CouchDbService {

    public static User getUserById(String userId) {
        // ডকুমেন্টের _id দিয়ে রিড করা
        User user = connector.get(User.class, userId);
        return user;
    }
}

এখানে, get() মেথডটি ব্যবহার করে নির্দিষ্ট _id এর সাথে ডকুমেন্টটি রিড করা হচ্ছে এবং এটি User অবজেক্ট হিসেবে ফেরত দেওয়া হচ্ছে।

5. CouchDB তে ডেটা আপডেট করা (Update Operation)

যদি ডেটাবেসে বিদ্যমান একটি ডকুমেন্ট আপডেট করতে চান, তবে প্রথমে সেটি রিড করতে হবে এবং তারপর প্রয়োজনীয় পরিবর্তন করতে হবে।

ডেটাবেসে ডকুমেন্ট আপডেট করা

public class CouchDbService {

    public static void updateUser(String userId, String newEmail) {
        // ডকুমেন্ট রিড করা
        User user = connector.get(User.class, userId);
        
        // ডেটার পরিবর্তন করা
        user.setEmail(newEmail);
        
        // ডেটাবেসে আপডেট করা
        connector.update(user);
    }
}

এখানে, update মেথডটি ব্যবহার করে আপনি একটি বিদ্যমান User ডকুমেন্টের email ফিল্ড আপডেট করতে পারেন।

6. CouchDB তে ডেটা ডিলিট করা (Delete Operation)

CouchDB তে একটি ডকুমেন্ট মুছে ফেলতে হলে _id এবং _rev ফিল্ড প্রয়োজন।

ডেটাবেস থেকে ডকুমেন্ট ডিলিট করা

public class CouchDbService {

    public static void deleteUser(String userId) {
        // ডকুমেন্ট রিড করা
        User user = connector.get(User.class, userId);
        
        // ডেটাবেস থেকে ডকুমেন্ট মুছে ফেলা
        connector.delete(user);
    }
}

এখানে, delete মেথডটি ব্যবহার করে একটি ডকুমেন্ট মুছে ফেলা হচ্ছে।

উপসংহার

Ektorp API ব্যবহার করে Java এ CouchDB এর ইন্টিগ্রেশন সহজ এবং কার্যকরী। এর মাধ্যমে আপনি ডেটা CRUD অপারেশন (Create, Read, Update, Delete) পরিচালনা করতে পারেন এবং CouchDB ডেটাবেসের সাথেও সহজে যোগাযোগ করতে পারেন। CouchDB তে Java ব্যবহার করার জন্য Ektorp একটি কার্যকরী এবং শক্তিশালী লাইব্রেরি হিসেবে কাজ করে, যা ডিস্ট্রিবিউটেড ডাটাবেসের সঙ্গে কাজ করা আরও সহজ করে তোলে।